Improve tooltip-text/markup docs

Clarify priorities between the two,
https://bugzilla.gnome.org/show_bug.cgi?id=681185

diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index a993db3f4d9ffbc7e7035fb3ddb66f911aba5ae4..ee4e316718ba110946dc433b49bf2effbecd499e 100644 (file)
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -1397,6 +1397,9 @@ G_GNUC_END_IGNORE_DEPRECATIONS
    * will automatically be set to %TRUE and there will be taken care of
    * #GtkWidget::query-tooltip in the default signal handler.
    *
+   * Note that if both #GtkWidget:tooltip-text and #GtkWidget:tooltip-markup
+   * are set, the last one wins.
+   *
    * Since: 2.12
    */
   g_object_class_install_property (gobject_class,
@@ -1418,6 +1421,9 @@ G_GNUC_END_IGNORE_DEPRECATIONS
    * will automatically be set to %TRUE and there will be taken care of
    * #GtkWidget::query-tooltip in the default signal handler.
    *
+   * Note that if both #GtkWidget:tooltip-text and #GtkWidget:tooltip-markup
+   * are set, the last one wins.
+   *
    * Since: 2.12
    */
   g_object_class_install_property (gobject_class,